IBM Books

Enhancements to Release 1.0 of the IBM 8371


Configuring a Backup ATM Interface for a LEC

Use the config command at the LE Client Config> prompt to access the appropriate Ethernet LEC interface number, or use the network configuration command with the appropriate Ethernet LEC interface number. The following commands are available at the Ethernet Forum Compliant LEC Config> command prompt.

Table 11. LAN Emulation Client Configuration Commands Summary
 Command   Function 
? (Help) Displays all the commands available for this command level or lists the options for specific commands (if available).
 ARP-Configuration   Allows you to configure the LE-ARP configuration for the ATM Forum-compliant client 
 IP-Encapsulation   Sets the IP encapsulation as Ethernet (type X'0800') or IEEE (802.3 with SNAP). Applies only to Ethernet LECs. 
 List   Lists the LAN Emulation Client configuration. 
 QoS-Configuration   Gets you to the LEC QoS Config prompt from which you can configure Quality of Service. 
 Set   Sets the LAN Emulation Client parameters, including backup interface and automatic switchback. 
Exit Returns you to the previous command level.

Only a discussion of the set command is included here. Refer to 8371 Networking Multilayer Ethernet Switch Software User's Guide and Configuration Reference, GC30-9688-00 for a description of all LEC commands.

Set

Use the set command to set LE Client parameters.

Syntax:

set
arp-aging-time

 
arp-cache-size

 
arp-queue-depth

 
arp-response-time

 
auto-config

 
backup atm-net#

 
best-effort-peakrate

 
bus-connect-retries

 
conn-completion-time

 
control-timeout

data-direct-timeout

data-direct-vcc-mode

 
elan-name

 
esi-address

 
flush-timeout

 
forward-delay

 
forward-disconnect-timeout

 
frame-size

 
initial-control-timeout

 
lecs-atm-address

 
les-atm-address

 
mac-address

 
multicast-send-avg

 
multicast-send-peak

 
multicast-send-type

 
multiplier-control-timeout

 
path-switch-delay

 
reconfig-delay-min

 
reconfig-delay-max

 
retry-count

 
selector

switchback

 
trace

 
unknown-count

 
unknown-time

 
vcc-timeout

arp-aging-time
Sets ARP aging time. This is the maximum time that a LEC will maintain an entry in its LE_ARP cache in the absence of a verification of that relationship. A larger aging time may result in a faster session setup time, but may also use more memory and reacts slower to changes in network configuration.

Valid Values:
An integer number of seconds in the range of 10 to 300.

Default Value:
300

Example:

   LEC Config> set arp-aging-time 200

arp-cache-size
Sets the number of entries in the ARP cache. The size of the ARP cache limits the number of simultaneous data direct VCCs. Larger ARP caches require more memory, but permit the client to simultaneously converse with a larger number of destinations.

Valid Values:
An integer number in the range of 10 to 65535.

Default Value:
5000

Example:

  LEC Config> set arp-cache-size 10

arp-queue-depth
Sets the maximum number of queued frames per ARP cache entry. The LEC queues frames when switching the data path from the Multicast Send VCC to a Data Direct VCC. Frames passed to the LEC for transmission will be discarded if the queue is full. A larger queue requires more memory, but results in fewer discarded frames during the data path switch.

Valid Values:
An integer number in the range of 0 to 10.

Default Value:
5

Example:

  LEC Config> set arp-queue-depth 10

arp-response-time
Sets expected ARP response time. This value controls how frequently an unanswered LE ARP request is retried. Larger values result in fewer LE ARPs, which causes less traffic and possibly increase the amount of time before a Data Direct VCC is established.

Valid Values:
An integer number of seconds in the range of 1 to 30.

Default Value:
1 second

Example:

  LEC Config> set arp-response-time 20

auto-config
Specifies whether this LEC uses LECS auto-config mode. Specify YES or NO. The LEC may contact the LECS to obtain the address of its LES and various other configuration parameters.

Valid Values:
If YES, then you do not have to configure the ATM address of the LES.

If NO, then you must configure the ATM address of the LES using the set les-atm-address command as described on page ***.

Default Value:
NO

Example:

  LEC Config> set auto-config yes

backup atm-net#
Sets the ATM net number of the backup ATM interface to be used as the ATM interface for the LEC in case of the primary ATM interface failure. This backup ATM interface can be concurrently functioning as the primary ATM interface for other LECs.

best-effort-peakrate
Sets the Best Effort Peak Rate. Used when establishing best effort multicast send connections.

The maximum peak rate depends on the maximum data rate of the ATM device.

Specify an integer from 1 to the maximum peak rate in Kbps (the definition is the maximum data rate) as follows:

Valid Values:
An integer number in the range of 1 - device maximum data rate.

Default Value:
155000

Example:

  LEC Config> set best-effort-peakrate 24000

bus-connect-retries
This parameter sets the maximum number of times that the LEC will attempt to reconnect to the BUS before returning to the initial state.

Valid Values:
0 - 2

Default Value:
1

connection-completion-time
Sets the connection completion time. This is the time interval in which data or a READY_IND message is expected from a calling party.

When a Data Direct VCC is established to the client, the LEC expects data or a READY_IND message within this time period. The LEC will not transmit frames over a Data Direct VCC established to it until receiving data or a READY_IND. This parameter value controls the amount of time which passes before the LEC issues a READY QUERY (in hopes of receiving a READY_IND). Smaller values lead to faster response times, but also to unnecessary transmissions.

Valid Values:
An integer number of seconds in the range of 1 to 10.

Default Value:
4

Example:

  LEC Config> set connection-completion-time 5

control-timeout
This parameter sets the maximum cumulative control timeout of a request.

A current timeout value is initialized to the value of initial-control-timeout. If a response to a request is not received within the current timeout value, the current timeout is multiplied by the value of the multiplier-control-timeout and the request is reissued. Each time the current timeout value expires, this process is repeated until the current timeout value exceeds the value of control-timeout.

Valid Values:
An integer number of seconds in the range of 10 to 300.

Default Value:
30

Example:

  LEC Config> set control-timeout 100

data-direct-timeout
Specifies the timeout value for the data direct VCC. This parameter limits the time the Data Direct VCCs are left up without the LEC having a connection to the LES/BUS.

Valid Values:
10 - 300 seconds

Default Value:
30

data-direct-vcc-mode
Specifies whether persistent Data Direct VCC mode is enabled or disabled. When the Data Direct VCC mode is enabled, if the LEC loses its connection to the LES/BUS, the Data Direct VCCs are not dropped and the reconnect timeout timer is started.

Valid Values:
yes or no

Default Value:
no

elan-name
Specifies name of the ELAN that the LEC wishes to join. This is the ELAN name sent to the LECS in the configure request (if the LEC autoconfigures) or to the LES in the join request. The LECS or LES may return a different ELAN name in the response.

Valid Values:
Any character string length of 0 - 32 bytes.

Default Value:
Blank
Note:A blank name (0 length string) is valid.

Example:

  LEC Config> set elan-name FUZZY

esi-address
Sets the ESI portion of the LEC's ATM address.

Specify the ESI portion (octets 13 through 19) of the LEC's ATM address. The ESI and selector combination of the LEC must be unique among all LAN emulation components on the device.

Valid Values:
Any 12 hexadecimal digits.

Default Value:
Burned-in ESI

Example:

  set esi
  Select ESI
     (1) Use burned in ESI
     (2) 11.22.33.44.55.66
 
  Enter selection [1]?

flush-timeout
Sets the flush timeout. This is the time limit to wait to receive the LE_FLUSH_RESPONSE after the LE_FLUSH_REQUEST has been sent before taking recovery action. During recovery, any queued frames are dropped and a new flush request is sent.

When switching from the multicast send to a data direct data path, the client sends a flush request over the multicast send VCC. Until a flush response is received, or until the path switch delay expires, frames are queued for the destination.

Valid Values:
An integer number of seconds in the range of 1 to 4.

Default Value:
4

Example:

  LEC Config> set flush-timeout 3

forward-delay
Sets the forward delay. Entries in the LE ARP cache must be periodically re-verified. The forward delay time is the maximum amount of time a remote entry may remain in the cache during a network topology change. Larger aging times may result in stale (invalid) entries, but also cause less re-verification traffic.

Valid Values:
An integer number of seconds in the range of 4 to 30.

Default Value:
15

Example:

  LEC Config> set forward-delay 10

forward-disconnect-timeout
This parameter sets the amount of time that a LEC will wait after losing its last Multicast Forward VCC from the BUS before returning to the initial state. This delay permits the BUS to attempt to reconnect to the client without returning to the initial state.

Valid Values:
10 - 300 seconds

Default Value:
60

frame-size
Sets the frame size.

The value specified for frame-size must be equal to or less than the value specified for ATM max-frame using the ATM INTERFACE> set max-frame command.

Valid Values:
1516

4544

9234

18190

Default Value:
If the ELAN type is token ring, the default is 4544. If the ELAN type is Ethernet, the default is 1516.

Example:

  LEC Config> set frame-size 4544

initial-control-timeout
This parameter sets the value of the initial control timeout used in the control timeout algorithm described in ***.

Valid Values:
1 - 10

Default Value:
5

Example:

  LEC Config> set initial-control-timeout 10

lecs-atm-address
Specifies the ATM address of the LECS.

If the client is set to auto configure, it attempts to connect to a LECS. If it is unable to connect to a LECS, then it may try another LECS ATM address. The LECS ATM addresses that are tried, in order, are:

  1. This configured LECS address
  2. Any LECS address obtained through ILMI
  3. The well-known LECS address defined by the ATM Forum.

No default is provided.
Note:This command should be entered on one command line. It is shown here on two lines because of spacing.

Example:

  LEC Config> set lecs-atm-address
39.84.0F.00.00.00.00.00.00.00.00.00.01.10.00.5A.00.DE.AD.01

les-atm-address
Sets the LES ATM address. This command may be optional or required depending upon the setting of lecs-auto-config as described in the set auto-config command on page ***.

Specify the ATM address of the LES. No default is provided.
Note:This command should be entered on one command line. It is shown here on two lines because of spacing.

Example:

  LEC Config> set les-atm-address
        39.84.0F.00.00.00.00.00.00.00.00.00.01.10.00.5A.00.DE.AD.02

mac-address
Sets the MAC address for this LE client. You may specify that the client use the burned-in MAC address of the ATM interface, or you may specify a different MAC address. If you have two clients that are bridged together, they should use different MAC addresses.

This MAC address is registered with the LES when the client joins the ELAN.

Valid Values:
Any valid MAC address.

Default Value:
none

Example:

  LEC Config> set mac-address
    Use adapter address for MAC? [No]
    MAC address []: 10.00.5a.00.00.01

multicast-send-avg
Sets the multicast send VCC average rate in Kbps. Used by the LEC for reserving bandwidth on the VCC to the BUS. It specifies the forward and backward sustained cell rate used when setting up a reserved bandwidth multicast send VCC.

This parameter is only applicable when the multicast-send-type is reserved bandwidth. If multicast-send-avg equals multicast-send-peak, then a constant bit rate (CBR) multicast send is signalled. Otherwise, a variable bit rate (VBR) multicast send is signalled. Multicast-send-avg must be less than or equal to multicast-send peak.

A reserved bandwidth multicast send VCC may improve data transfer rates in congested networks, but reserving bandwidth and not using it wastes network resources.

When the multicast-send-type is reserved, then multicast-send-avg and multicast-send-peak must be specified.

Example:

  LEC Config> set multicast-send-avg 4000

multicast-send-peak
Sets the multicast send peak rate in Kbps. Used by LEC for reserving bandwidth on the VCC to the BUS. It specifies the forward and backward peak cell rate used when establishing a reserved bandwidth multicast send VCC.

This parameter is only applicable when the multicast-send-type is reserved bandwidth. If multicast-send-avg equals multicast-send-peak, then a constant bit rate (CBR) multicast send is signalled. Otherwise, a variable bit rate (VBR) multicast send is signalled. Multicast-send-avg must be less than or equal to multicast-send peak.

A reserved bandwidth multicast send VCC may improve data transfer rates in congested networks, but reserving bandwidth and not using it wastes network resources.

When the multicast-send-type is reserved, then multicast-send-avg and multicast-send-peak must be specified.

Example:

  LEC Config> set multicast-send-peak 155

multicast-send-type
Sets the multicast send type. Specifies the method used by the LEC when establishing the multicast send VCC.

If multicast-send-avg equals multicast-send-peak, then a constant bit rate (CBR) multicast send is signalled. Otherwise, a variable bit rate (VBR) multicast send is signalled. Multicast-send-avg must at least equal multicast-send peak.

A reserved bandwidth multicast send VCC may improve data transfer rates in congested networks, but reserving bandwidth and not using it wastes network resources.

When the multicast-send-type is reserved, then multicast-send-no and multicast-send-peak must be specified.

Valid Values:
Best Effort or Reserved

Default Value:
Best Effort

Example:

  LEC Config> set multicast-send-type best-effort

multiplier-control-timeout
This parameter sets the value of the control timeout multiplier used in the control timeout algorithm described on page ***.

Valid Values:
2 - 5

Default Value:
2

Example:

  LEC Config> set multiplier-control-timeout 5

path-switch-delay
Sets the path switch delay.

The LEC must ensure that all frames sent through the BUS to a destination have arrived at the destination before it can start using a Data Direct VCC. This is accomplished using the flush protocol, or by waiting path-switch-delay seconds after sending the last packet to the BUS. Smaller values improve performance, but may result in out-of-order packets in a heavily congested network.

Valid Values:
An integer number of seconds in the range of 1 to 8.

Default Value:
6

Example:

  LEC Config> set path-switch-delay 5

reconfig-delay-min
This parameter sets the minimum delay time when LEC returns to the initial state. This value must be <= reconfig-delay-max.

Valid Values:
1 - the value of reconfig-delay-max

Default Value:
1

Example:

  LEC Config> set reconfig-delay-min  5

reconfig-delay-max
This parameter sets the maximum delay time when LEC returns to the initial state. This value must be >= reconfig-delay-min.

Valid Values:
1 - 10

Default Value:
5

Example:

  LEC Config> set reconfig-delay-max 9

retry-count
Sets the retry count. This is maximum number of times that the LEC retries an LE_ARP_REQUEST for a specific frame's LAN destination. If no ARP response is received after the specified number of retries, then the entry is purged from the LE ARP cache.

Valid Values:
0, 1, or 2

Default Value:
1

Example:

  LEC Config> set retry-count 2

selector
Specifies the selector portion of the client's ATM address. The combination of ESI and selector must be unique among all LANE components on the device. By default, a unique selector is selected for the configured ESI.

Valid Values:
Any octet, in hexadecimal, that is not in use by another LANE component with the same ESI.

Example:

  LEC Config> set selector 01

switchback
Specifies whether automatic switchback is enabled or disabled.

If enabled (yes), the LEC will automatically switch back to the primary ATM if the primary interface becomes available while the LEC is operating over the backup ATM interface.

If disabled (no), the LEC will continue to operate over the backup ATM interface even if the primary ATM interface becomes available. You can force the LEC to switch back to the primary ATM interface by issuing the switchback command from the talk 5 LEC+ command prompt.

Also if disabled (no), the LEC will switch back to the primary ATM interface is the primary interface is available and the backup interface fails while the LEC is operating over the backup interface.

If both the primary and backup ATM interfaces fail, the LEC will begin operating over the interface which becomes available first.

Valid Values:
yes or no

Default Value:
no

trace
Enables tracing for the LEC. To perform packet tracing, three steps are required:
  1. Enable packet tracing system (under ELS)
  2. Enable tracing on the LEC subsystem (under ELS)
  3. Enable packet tracing on the desired LECs (using this command).

Valid Values:
Yes or No

Default Value:
No

unknown-count
Sets the unknown frame count. This is the maximum number of frames for a specific unicast MAC address or route descriptor that may be sent to the BUS within the time specified by the unknown-time parameter. Larger values decrease the number of discarded frames while increasing the load on the BUS.

Valid Values:
An integer number of frames in the range of 1 to 255.

Default Value:
10

unknown-time
Sets the unknown frame time. This is the time interval during which the maximum number of frames for a specific unicast MAC address or route descriptor (specified by the unknown-count parameter) may be sent to the BUS. Larger values increase the number of discarded frames while decreasing the load on the BUS.

Valid Values:
An integer number of seconds in the range of 1 to 60.

Default Value:
1

Example:

  LEC Config> set unknown-time 5

vcc-timeout
Sets the VCC timeout. Data direct VCCs over which no traffic has been sent for this period of time should be released.

Valid Values: 0 to 31536000 seconds (1 year).

Default Value: 1200
Note:This parameter is meaningful only for SVC connections.

Example:

  LEC Config> set vcc-timeout 1000


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]